<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Contains definition of chart device renderers</title>
<style>@import url("file:/c:/Program Files/eclipse3.1/plugins/org.eclipse.sdk_3.1.0/book.css");</style>
<style>@import url("file:/c:/Program Files/eclipse3.1/plugins/org.eclipse.platform.doc.isv_3.1.0/schema.css");</style>
</HEAD>
<BODY>
<H1><CENTER>Contains definition of chart device renderers</CENTER></H1>
<p></p>
<h6 class=CaptionFigColumn id=header>Identifier: </h6>org.eclipse.birt.chart.engine.devicerenderers<p></p>
<h6 class=CaptionFigColumn id=header>Since: </h6>1.0.0
<p></p>

<p>
<h6 class=CaptionFigColumn id=header>Description: </h6>The DeviceRenderer extension point allows custom implementations of device renderers to be plugged into the chart library to generate charts in new output formats.</p>
<p><h6 class=CaptionFigColumn id=header>Configuration Markup:</h6></p>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.extension">extension</a> (<a href="#e.deviceRenderer">deviceRenderer</a>)&gt;</p>
<p class=code id=dtd>&lt;!ATTLIST extension</p>
<p class=code id=dtdAttlist>point&nbsp;CDATA #REQUIRED<p class=code id=dtdAttlist>id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED<p class=code id=dtdAttlist>name&nbsp;&nbsp;CDATA #IMPLIED&gt;</p>
<p></p>
<ul class=ConfigMarkup id=attlistDesc>
</ul>
<br><p class=code id=dtd>&lt;!ELEMENT <a name="e.deviceRenderer">deviceRenderer</a> EMPTY&gt;</p>
<p class=code id=dtd>&lt;!ATTLIST deviceRenderer</p>
<p class=code id=dtdAttlist>name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED<p class=code id=dtdAttlist>device&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED<p class=code id=dtdAttlist>format&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED<p class=code id=dtdAttlist>description&nbsp;CDATA #IMPLIED&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
A device renderer extension point specifies a mapping entry between a device renderer name against the device renderer implementing class name. Note that all device renderer implementations must subclass the base device renderer implementation provided i.e. org.eclipse.birt.chart.device.DeviceAdapter and override methods as needed. A device renderer is responsible for rendering primitive instructions and handling user events in a particular output format.</p>
<br>
<ul class=ConfigMarkup id=attlistDesc>
<li><b>name</b> - The name of the device renderer refers to a tag used to locate the device renderer implementing class. The naming convention uses a prefix of 'dv.'. Examples of device renderer names are dv.SWT and dv.SWING</li>
<li><b>device</b> - The device attribute corresponds to the fully qualified class name that represents the implementing device renderer class. An example of the fully qualified device renderer class name is 'org.eclipse.birt.chart.device.swt.SwtRendererImpl'</li>
<li><b>format</b> - @Since 2.0. The format attribute indicates a file format which this device renderer can generate, such as "BMP", "JPG", "GIF", etc.</li>
<li><b>description</b> - @Since 2.0. The description of the device renderer elaborates the format detail if the "format" attribute exists or the functionality this device renderer holds.</li>
</ul>
<br><h6 class=CaptionFigColumn id=header>Examples: </h6><extension
         point="org.eclipse.birt.chart.engine.devicerenderers">
      <deviceRenderer
            device="org.eclipse.birt.chart.device.swing.SwingRendererImpl"
            name="dv.SWING"/>
      <deviceRenderer
            device="org.eclipse.birt.chart.device.swt.SwtRendererImpl"
            name="dv.SWT"/>
      <deviceRenderer
            device="org.eclipse.birt.chart.device.image.PngRendererImplOld"
            name="dv.PNG24"/>
      <deviceRenderer
            device="org.eclipse.birt.chart.device.image.GifRendererImplOld"
            name="dv.GIF8"/>
      <deviceRenderer
            device="org.eclipse.birt.chart.device.image.PngRendererImpl"
            name="dv.PNG"
            format="PNG"
            description="Protable Network Graphics"/>
      <deviceRenderer
            device="org.eclipse.birt.chart.device.image.GifRendererImpl"
            name="dv.GIF"/>
      <deviceRenderer
            device="org.eclipse.birt.chart.device.image.JpegRendererImpl"
            name="dv.JPEG"/>
      <deviceRenderer
            device="org.eclipse.birt.chart.device.image.JpegRendererImpl"
            name="dv.JPG"/>
      <deviceRenderer
            device="org.eclipse.birt.chart.device.image.BmpRendererImpl"
            name="dv.BMP"/>
   </extension>
<p></p>

<h6 class=CaptionFigColumn id=header>API Information: </h6>Please refer to the javadocs for IDeviceRenderer in the <i>org.eclipse.birt.chart.device</i> package.
<p></p>

<h6 class=CaptionFigColumn id=header>Supplied Implementation: </h6>The <i>org.eclipse.birt.chart.device.extension</i> plug-in provides device renderers for default supported output devices.
<p></p>

<br>
<p class=note id=copyright>
Copyright (c) 2004-2005 Actuate Corporation.
All rights reserved. This program and the accompanying materials are made available under the  terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html
<p></p>

</p>
</BODY>
</HTML>
